package com.ruoyi.training.mapper;

import java.util.List;
import com.ruoyi.training.domain.SpecialCertificate;
import com.ruoyi.training.dto.certificate.SpecialCertificateDto;
import com.ruoyi.training.vo.certificate.SpecialCertificateVo;
import org.apache.ibatis.annotations.Param;

/**
 * 特设证书管理Mapper接口
 * 
 * @author hcc
 * @date 2025-11-06
 */
public interface SpecialCertificateMapper 
{
    /**
     * 查询特设证书管理
     * 
     * @param specialCertificateId 特设证书管理主键
     * @return 特设证书管理
     */
    public SpecialCertificate selectSpecialCertificateBySpecialCertificateId(String specialCertificateId);

    /**
     * 查询特设证书管理列表
     * 
     * @param specialCertificate 特设证书管理
     * @return 特设证书管理集合
     */
    public List<SpecialCertificate> selectSpecialCertificateList(SpecialCertificate specialCertificate);

    /**
     * 新增特设证书管理
     * 
     * @param specialCertificate 特设证书管理
     * @return 结果
     */
    public int insertSpecialCertificate(SpecialCertificate specialCertificate);

    /**
     * 修改特设证书管理
     * 
     * @param specialCertificate 特设证书管理
     * @return 结果
     */
    public int updateSpecialCertificate(SpecialCertificate specialCertificate);

    /**
     * 删除特设证书管理
     * 
     * @param specialCertificateId 特设证书管理主键
     * @return 结果
     */
    public int deleteSpecialCertificateBySpecialCertificateId(String specialCertificateId);

    /**
     * 批量删除特设证书管理
     * 
     * @param specialCertificateIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteSpecialCertificateBySpecialCertificateIds(String[] specialCertificateIds);

    /**
     * 根据学生id和项目id查询特设证书管理
     *
     * @param studentId 学生id
     * @param projectId 项目id
     * @return 特设证书管理
     */
    public SpecialCertificate getByStudentIdAndProjectId(@Param("studentId") String studentId, @Param("projectId") String projectId);

    /**
     * 根据学生id查询特设证书管理
     *
     * @param studentId 学生id
     * @return 特设证书管理
     */
    public List<SpecialCertificate> getByStudentId(@Param("studentId") String studentId);

    /**
     * 查询特设证书管理列表
     *
     * @param specialCertificateVo 特设证书管理
     * @return 特设证书管理集合
     */
    public List<SpecialCertificateDto> getSpecialCertificateList(SpecialCertificateVo specialCertificateVo);

    /**
     * 根据报名id查询特设证书管理
     *
     * @param registrationId 报名id
     * @return 特设证书管理
     */
    public SpecialCertificate selectSpecialCertificateByRegistrationId(String registrationId);
}
